home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / bildschirmschoner / beyondthedark / documentation / english / btd.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  30KB  |  413 lines

  1. @DATABASE BTD.guide
  2. @$VER: BTD.guide_english V0.1
  3. @AUTHOR "Markus Illenseer"
  4. @(C) Copyright 1995 Markus Illenseer, Bielefeld, Germany
  5. @WORDWRAP
  6. @WIDTH 77
  7. @MASTER "BTD.guide"
  8. @INDEX INDEX
  9. ## This  is  a  doc  file in the amigaguide.library format.
  10. ## The needed programm is avail since May 1993.  AmigaGuide
  11. ## can  be  found  on  either  the  Aminet  or  on  a later
  12. ## Fish-Disc  >880.   Also, for the blessed A4000 and A1200
  13. ## user, multiview of WB 3.0 does support this guide.
  14. @Node INDEX "Index - TOC"
  15. @{" Synopsis              " Link SYNOPSIS}
  16. @{" Description           " Link DESCRIPTION}
  17. @{" Source Code           " Link SOURCE}
  18. @{" Copyright             " Link COPYRIGHT}
  19. @{" Authors & Support     " Link AUTHOR}
  20. @{" Changes               " Link CHANGES}
  21. @{" Purpose & Theorie     " Link PURPOSE}
  22. @{" Version               " Link VERSION}
  23. @{" Start                 " Link STARTING}
  24. @{" Preference Window     " Link EDIT}
  25. @{" Commodities Exchange  " Link EXCHANGE}
  26. @{" Screen Resolutions    " Link DISPLAY}
  27. @{" MUI System            " Link MUI}
  28. @{" Modules               " Link BLANKERS}
  29. @{" Rexx                  " Link REXX}
  30. @{" Known Problems        " Link PROBLEMS}
  31. @{" Credits               " Link CREDITS}
  32. @{" History               " Link HISTORY}    
  33. @EndNode
  34. @Node MAIN "Beyond the Dark V1.0  - Manual"
  35.     @{fg fill}@{b}BTD V1.0  - Manual@{ub}@{fg text}
  36.    I.      @{" Synopsis              " Link SYNOPSIS}
  37.    II.     @{" Description           " Link DESCRIPTION}
  38.    III.    @{" Source Code           " Link SOURCE}
  39.    IV.     @{" Copyright             " Link COPYRIGHT}
  40.    V.      @{" Authors & Support     " Link AUTHOR}
  41.    VI.     @{" Changes               " Link CHANGES}
  42.    VII.    @{" Purpose & Theorie     " Link PURPOSE}
  43.    VIII.   @{" Version               " Link VERSION}
  44.    IX.     @{" Start                 " Link STARTING}
  45.    X.      @{" Preference Window     " Link EDIT}
  46.    XI .    @{" Commodities Exchange  " Link EXCHANGE}
  47.    XII.    @{" Screen Resolutions    " Link DISPLAY}
  48.    XIII.   @{" MUI System            " Link MUI}
  49.    XIV.    @{" Modules               " Link BLANKERS}
  50.    XV.     @{" Rexx                  " Link REXX}
  51.    XVI.    @{" Known Problems        " Link PROBLEMS}
  52.    XVII.   @{" Credits               " Link CREDITS}
  53.    XVIII.  @{" History               " Link HISTORY}    
  54. @EndNode
  55. @Node SYNOPSIS "BTD/Synopsis"
  56. @{b}NAME@{ub}
  57.    BTD:BTD-CX (Commodity)
  58.    BTD:BTD    (Preference Program)
  59. @{b}Synopsis@{ub}
  60.    BTD-CX (No Paramters)  The Blanker
  61.    BTD (No Paramters)     Preference Program
  62. @EndNode
  63. @Node DESCRIPTION "BTD/Description"
  64. @{b}Beschreibung@{ub}
  65. Modular Screen Blanker with high security features, does not burn the graphics into the Monitor when the CPU is busy. Does only work under Workbench Release 2.04 and above. Requires the @{"MUI" Link MUI} User Interface for the preference program, but does work without MUI!
  66. BTD is the preference program, where all of the modules can individually be configured. This program requires MUI 2.1 and above, but don't worry, MUI will only be required for the preference program.
  67. BTD-CX is the blanker itself, running with comfortably stability. From ENV:BTD.prefs the blanker will read the preferences configured with BTD and will load the modules on demand.
  68. Whilst seperating the user interface and the real blanker, it was made possible to minimize the needs in terms of memory and CPU. Only very few kilobytes are actually allocated, the modules themself even are only loaded on demand and freed upon non-usage.
  69. The blankers themsel, the modules we call them, are shared libraries and therefore can be flushed out of memory if not in use.
  70. @EndNode
  71. @Node SOURCE "BTD/Source Code"
  72. @{b}Source Code@{ub}
  73. The sources for some of the modules are distributed and can be compiled with SAS/C 6.50 and newer, or with a registered version of DICE V2.06.54 and newer.
  74. The sources are distributed to give interested programmers a chance to make their own modules.
  75. Please do @{b}not@{ub} re-distribute changed or optimized versions of these modules under the same name. This would confuse the users and simply is unfair, too. Please let the author of a module know what you would like to have changed, and let him decide to update the module, or write your own module and distribute this one.
  76. @EndNode
  77. @Node COPYRIGHT "BTD/Copyright"
  78. @{b}Copyright@{ub}
  79. Copyright @ 1994 and 1995 by the Beyond the Dark Group.
  80. Author of the preference tool and the server is
  81.    Matthias Scheler            
  82.    Sch
  83. tzenstra
  84. e 18           
  85.    33178 Borchen               
  86.    Germany
  87. BTD V1.0  is freely distributable.
  88. BTD V1.0  is Giftware. If you believe BTD pleases you and you think the authors deserve it, send them a small gift. Whatever it is, we sure will like every present, ie. a chocolate, a key file for your program, a CD-ROM. Nobody should feel obliged though to send anything, but it would be fair and honest...
  89. BTD V1.0  can be distributed on Public-Domain and Shareware Disks, as long as these are not sold or a price execeeding the costs of a copy fee and distribution, this is as much as US$6 or DM 8.- per disk.
  90. For use in conjunction or integration with commercial products, a permission is to obtain from the authors.
  91. BTD V1.0  can be copied and redistributed over electronic networks such as the Internet, also it may be made available on anonymous FTP-Serves, Mail-Boxes or Boards.
  92. BTD V1.0  can be distributed on freely obtainable CD-ROMs.  Diese CD-ROM darf nicht kommerziell verwendet (z.B.  professionelle Kopierstation) werden.  The price of the CD is not important, though we strongly recommend to sell the CD for about 13$US or DM19.80 but no more than 20$US or DM29.80.
  93. There is no excplicit permission given for specific CD-ROMS, but we hereby grant the permission to distribute on the CD-ROMs 'Meeting Pearls', 'Aminet' and 'AmigaLib'.
  94. BTD V1.0  is not to be used by military institutions and other institutions serving for military purposes.
  95. The Copyright 
  96.  is still by the authors.
  97. The sources can be changes or even be optimized. But please to @{b}not@{ub} distribute your own version of BTD unde the name of BTD, use your own name.
  98. The authors are not responsible or held responsible for any damage caused by the usage of BTD V1.0  or other versions of BTD, not even for hypnosetic Trauma.
  99. @EndNode
  100. @Node AUTHOR "BTD/Authors & Support"
  101. @{b}Authors & Support@{ub}
  102.    Matthias Scheler            # Server-Client Model
  103.    Sch
  104. tzenstra
  105. e 18            # User interface
  106.    33178 Borchen                 # SAS/C Support
  107.    Germany
  108.    INTERNET: tron@lyssa.owl.de
  109.    FIDO    : Matthias Scheler 2:243/6301.223
  110.    IRC: Tron
  111.    Markus Illenseer            # many Blankermodules
  112.    Kurt-Schumacherstra
  113. e 16     # Documentation
  114.    33615 Bielefeld               
  115.    Germany
  116.    INTERNET: markus@tiger.teuto.de
  117.    IRC: ill
  118.    WWW: http://www.teuto.de/~markus
  119.    SUPPORT FTP ADDRESS:
  120.    ftp.Uni-Paderborn.de [131.234.10.42] anonymer access.
  121.    (and therefore any Aminet Mirror round the globus)
  122.    Please first refer to the topic "KNOWN PROBLEMS" before trying to contact us for a bug report. Comments are of course welcomed.
  123. @EndNode
  124. @Node CHANGES "BTD/Changes"
  125. @{b}Changes@{ub}
  126. The hereby distributed Version V1.0  is the first official Release for all interested users. It will serve as large field test to detect problems and to ask for ideas and enhancements.
  127. This version sure is not perfect, all problems are asked to be reported promptly to the authors!
  128. @EndNode
  129. @Node PURPOSE "BTD/Purpose & Theory"
  130. @{b}Purpose and Theory@{ub}
  131. The BTD-Package is a screen blanker. Splitted into a preference program and the continously runnning blanker server, it will only require very few amounts of memory, will non the less offer interesting modules and is all over even capable to show several modules at the same time on the same screen.
  132. The goal of a screen blanker should be to turn off the screen, or to prevent all activity on the screen, and then prevent that pixels can burn into the monitors phosphor, or even more bad, to prevent ghost images when the screen is really turned off.
  133. As it is quite boring only to turn off the screen, and the Amiga is a true multitasking machine, we could offer some funny things on the screen, until the screen is really turned off.
  134. We only have to ake care about that our very own graphics does not burn into the monitor, when we do not get a bigger chunk of CPU time ourself.
  135. This happens, wenn another, important program requires much CPU time, such as a C-Compiler or Raytracer.
  136. There are hence two possible states. The blanker gets CPU time or nor. When it does, we can draw or graphics, when not, the screen is to be shut down, turned off.
  137. Technically we do that with a simple server-client modell. The server runs with normal priority, and has no more than a WaitPort()-Loop (no real CPU usage!) and sends commands to the client after the TIMEOUT is reached. The client runs with low priority. If the client does not answer after a timeout, another, more important program is overtaking him. We then have to turn of the screen. Please do not try to give the client a higher priority.
  138. The above mentioned client are modules. Each module is a library, which can be loaded on demand (!), and be driven over a standardized interface.
  139. It is fairly easy to write your own module, try it! You only need to know about C or assembler.
  140. There have been (long) discusions on comp.sys.amiga.misc (Usenet 1992) where we discussed the security of screen blankers. We believe that BTD fits the need pefectly.
  141. @EndNode
  142. @Node VERSION "BTD/Version"
  143. @{b}Version@{ub}
  144.  BTD 1.0
  145.  BTD-CX 1.0
  146. @EndNode
  147. @Node STARTING "BTD/Start"
  148. @{b}Start@{ub}
  149. BTD-CX is a commodity and therefor only runs under Workbench 2.04 (V37.175) and above.
  150. BTD is the preference tool to configure all options.
  151. Both programs do not have paramters.
  152. For the preference (and only for it!) the Magic User Interface (MUI) with the version 2.1 and above is required. 
  153. Distributed is an Install-Script, for which you need the Installer from Commodore. 
  154. A commodity normally will be started from the "SYS:WBStartup"-drawer. This way it will be started automatically.
  155. To ease the installation and the de-installation, we thought it might be better to change this a bit:
  156. This archive is to be unpacked in the usual manner somewhere. Then set an Assign with the Name "BTD" to this directory. In 'S:User-startup' you will then need to add the following lines:
  157.  Assign BTD: MyDrive:MyTools/BeyondTheDark
  158.  Run >NIL: BTD/BTD-CX
  159. The best is to copy the modules to BTD:Blankers, if they aint there already.
  160. To start BTD-CX right now, without rebootung, just double-click the icon in the usual manner.
  161. Then change the options with BTD, start this tool in the usual manner, too.
  162. BTD-CX is now started.  After 60 seconds the screen will be blanked, o course only if you haven't changed anything in the preferences ye and haven't touched a key and the mouse.
  163. If you haven't changed any options in BTD, you will only see a black screen.
  164. @EndNode
  165. @Node HOTKEY "BTD/Hotkeys"
  166. @KeyWord Hotkeys
  167. @{b}Hotkeys@{ub}
  168. @{b}Hot Key@{ub}
  169. Refer to your AmigaDOS Manual (Section The Extras Programs, The Commodities Drawer) to get a valid list of the available hot keys, the following may obsolete on a new "commodities.library" version.
  170. The Hot Keys can be edited with the String-Gadgets in the @{"Preference-Window " Link EDIT} of BTD.  The syntax and correctness is checked.
  171. One word for typing the Hot Keys:
  172. In the String-Gadget a description of the Hot Key in textform is beeing asked, not the Hot Key himself.  Thus the Hot Key 'left Amiga Key + q' would be typed in as 'lcommand q' (all ten chars inclusive the space).  After the Key was added to the Commodities Queue, the Hot Key can be activated by pressing and holding the left Amiga Key followed by pressing and releasing the 'q' Key and releasing the left Amiga Key.
  173.    SYNOPSIS:  [<qualifier> [<qualifier>...]] <key>
  174.        Qualifier keywords (Press and hold one or more qualifier)
  175.        @{b}alt           @{ub}either Alt key
  176.        @{b}ralt          @{ub}right Alt key
  177.        @{b}lalt          @{ub}left Alt key
  178.        @{b}shift         @{ub}either Shift key
  179.        @{b}rshift        @{ub}right Shift key
  180.        @{b}lshift        @{ub}left Shift key
  181.        @{b}capslock      @{ub}Caps Lock key
  182.        @{b}rcommand      @{ub}right Amiga key
  183.        @{b}lcommand      @{ub}left Amiga key
  184.        @{b}control       @{ub}Control key
  185.        @{b}numericpad    @{ub}Enables the use of a key on the numeric keypad
  186.        @{b}rbutton       @{ub}Click (and hold) the right mouse button
  187.        @{b}midbutton     @{ub}Click (and hold) the middle mouse button
  188.                      (only avail for mice with a connected third button!)
  189.        @{b}leftbutton    @{ub}Click (and hold) the left mouse button
  190.        @{b}newprefs      @{ub}Preferences changed
  191.        @{b}diskremoved   @{ub}Disk removed
  192.        @{b}diskinserted  @{ub}Disk inserted
  193.        Keys (to be pressed and released, only ONE Key can be chosen)
  194.        a .. z, 0 .. 9, etc.   Normal keys
  195.        f1 .. f10              Function keys
  196.        up, down, left, right  Cursor keys
  197.        help                   Help key
  198.        del                    Delete key
  199.        return                 Return key
  200.        enter                  Enter key
  201.                    (MUST be combined with 'numericpad'!)
  202.        backspace              Backspace key
  203.        esc                    Escape key
  204.        space                  Space key
  205.        comma                  Comma key
  206.        upstroke               Upstroke key
  207.        Examples
  208.        lalt ralt return
  209.        rcommand f10
  210.        alt x
  211.        lalt numericpad enter
  212.    NOTE:   Choose  your hotkeys @{b}carefully@{ub}, because
  213.    Commodities  have  a  high  priority in the input events
  214.    chain  (i.e.  will override existing definitions).  Also
  215.    some  hotkeys  don't make sense or do collide with other
  216.    tools or functions of the WB.
  217.    NOTE:   The  Workbench screen (or the default PubScreen,
  218.    if  this  one  has  activated the Shanghai-mode) will be
  219.    moved to front before starting the tool via HotKey.
  220.    NOTE:   When  a  combination  of  qualifiers and keys is
  221.    illegal,  BTD will start, but the Hot Key won't work.
  222.    Example for illegal combinations:
  223.        lalt a b                     # Two keys specified
  224.        control rcommand lcommand    # Reboots the System, Oops!
  225.        lbutton                      # No key specified
  226.    If  you  edit  the Hot Key's in the @{"Edit-Window" Link
  227.    EDIT  35}, the Combination will be checked.  If invalid,
  228.    the old Hot Key is still used.
  229.    NOTE:   Due  to  a bug in the commodities library, it is
  230.    impossible  to  use  a Mousebutton w/o a Qualifier and a
  231.    Key.(@{"ParseIX()"Link "Docs:AutoDocs/commodities.hyper/ParseIX()"} doesn't set
  232.    the ix_QualMask field right)
  233. @EndNode
  234. @Node EDIT "BTD/Configuration Window"
  235. @{b}Configuration Window@{ub}
  236. If you start BTD, a window will be opened to alter the options of BTD-CX.
  237. All preferences will be saved in ENV:BTD.prefs. Permanent changes will also be saved in ENVARC:BTD.prefs
  238. Blanker modules are only detected in BTD:Blankers. An Assign-ADD will make modules be visible from other pathes as well.
  239. We have tested the configuration window under many circumstances. Please tell us, if you have problems with it.
  240. You now will see some gadgets, hopefully they are not too confusing.
  241. By the input of a hot key, the given string will be checked, on error the old string will be used.
  242. You will see that most gadgets have a name with one char underlined, this is a hotkey for this gadget to reach options quickly over the keyboard.
  243. In Slider- and Cycle-Gadgets you can, after their activation, scroll with the cursor keys and set a value. See more in @{"MUI" Link MUI}.
  244. The window is seperated into three groups, according to your preferences in MUI, you will see a cycle-Gadget or a register group.
  245.    __________       ______________     ________________
  246.   / @{"Blankers" Link BLANKERS} \\     / @{"Display Mode" Link DISPLAY} \\   / Server Options \\
  247.   |           |-------------------------------------------
  248.   |                                                      |
  249.  Blankers:
  250. In the blanker part, you will see a listview. It is a multiple listview, where you can choose several modules at the same time.
  251. The active entries represen the to be used modules. On each blank, as many modules as a given by X- and Y-Resolution in the Server options, are beeing choosed for the blank screen. If not that much modules are available, random modules are activeted.
  252. If this option does not please our need, write us! We have been thinking for a long time about this topic and found this a good solution. Remember that we can run more than one module at the same time.
  253.  Display Mode:
  254. In usual manner you can choose your beloved screen resolution. New is the possibility to clone the active pubscreen, this prevents a re-synch of the monitor.
  255.    @{"Display Modi" Link DISPLAY}
  256.  Server Options:
  257. All options which are important for the real blanker are here.
  258.    @{"[T]imeout       " Link TIME  }
  259.    @{"C[l]ient timeout" Link CLIENT}    
  260.    @{"[F]inal Timeout " Link FINAL } 
  261.    @{"Blank [K]ey" Link BLANKKEY}
  262.    @{"[J]oystick " Link JOYSTICK}
  263.    @{"Blankers [X]" Link BLANKERS}
  264.    @{"Blankers [Y]" Link BLANKERS}
  265.    @{"Overview" Link MAIN}
  266. @EndNode
  267. @Node BLANKKEY "BTD/Edit Window/Blank Key"
  268. @{b}Configuration-Window/Blank Key@{ub}
  269.    BLANKKEY=<Hotkey>
  270.       Please read more in @{"Hotkeys" Link HOTKEY}.  
  271.       With this hotkey, the blanker will be started immediately.
  272.    @{"Overview" Link MAIN} @{"Configuration-Window" Link EDIT}
  273. @EndNode
  274. @Node TIME "BTD/Edit Window/Timeout"
  275. @{b}Configuration-Window/Timeout@{ub}
  276.    [T]imeout: <1 - 3600>
  277.       The given value for the timeout of the blanker.  After this time
  278.       (in seconds) the blanker will be enabled.
  279.    @{"Overview" Link MAIN} @{"Configuration-Window" Link EDIT}
  280. @EndNode
  281. @Node CLIENT "BTD/Edit Window/Client Timeout"
  282. @{b}Configuration-Window/Client Timeout@{ub}
  283.    C[l]ient timeout: <1 - 60>
  284.       The time the server gives to the client to respind and to work.
  285.       After this time the screen will be turned black!  One of the
  286.       major features of BTD!
  287.    @{"Overview" Link MAIN} @{"Configuration-Window" Link EDIT}
  288. @EndNode
  289. @Node FINAL "BTD/Edit Window/Final Timeout"
  290. @{b}Configuration-Window/Final Timeout@{ub}
  291.    [F]inal timeout: <0 | 1 - 3600>
  292.       The  time  ater  the  blanker  started.  After this timeout, the
  293.       screen  will  be  turned  black.   The value 0 will disable this
  294.       feature.
  295.    @{"Overview" Link MAIN} @{"Configuration-Window" Link EDIT}
  296. @EndNode
  297. @Node JOYSTICK "BTD/Edit Window/Joystick"
  298. @{b}Configuration-Window/Joystick@{ub}
  299.    [J]oystick: <Yes | No>
  300.       Enables the request for joystick movements.  This only required
  301.       for specific environments, ie.  for games which are not
  302.       compatible with screen blankers.
  303.    @{"Overview" Link MAIN} @{"Configuration-Window" Link EDIT}
  304. @EndNode
  305. @Node EXCHANGE "BTD/Commodities Exchange"
  306. @{b}Commodities Exchange@{ub}
  307. With the Commodities Exchange Tool you can temporairly disable BTD with DISABLE, and restart with ENABLE.
  308. This is a comfortable way to shut down BTD.
  309. Please also refer to your AmigaDOS manual, chapter AmigaDOS reference and workbench programs.
  310. @EndNode
  311. @Node DISPLAY "BTD/Display Modi"
  312. @{b}Please, please, please have care here !!!!"@{ub}
  313.    We are @{b}NOT@{ub} responsible for @{b}ANY@{ub} user-error.  The given list depends on the used System.  All newer Amigas, such as A500+ , A3000 do have the ECS Denise for extended Screen Modes (Notall Amiga's with Kick 2.0 on ROM do have a ECS Denise..).  Of course you can start the desired Modes, but not all modes are available on all MONITORS !  Please do refer to your Manual of the Monitor and to the AmigaDOS Manual (Section Workbench Programms, AddMonitor) for more informations.
  314.    Why ?  Simply because you can @{b}DESTROY@{ub} your Monitor!
  315.    Here is a list of the (normally given) ECS Display Modes:  This list may be obsolete when a new workbench is released.
  316.       NTSC:Lores
  317.       NTSC:Hires
  318.       NTSC:SuperHires
  319.       NTSC:Lores-Interlaced
  320.       NTSC:Hires-Interlaced
  321.       NTSC:SuperHires-Interlaced
  322.       PAL:Lores
  323.       PAL:Hires
  324.       PAL:SuperHires
  325.       PAL:Lores-Interlaced
  326.       PAL:Hires-Interlaced
  327.       PAL:SuperHires-Interlaced
  328.       VGA-ExtraLores                  # -
  329.       VGA-ExtraLores-Interlaced       #
  330.       VGA-Lores                       #
  331.       VGA-Lores-Interlaced            #   Multiscan Monitor needed
  332.       Productivity                    #
  333.       Productivity-Interlaced         # -
  334.       A2024_10Hz                      #
  335.       A2024_15Hz                      #   A2024 needed.
  336.    Other Modes are available from 3rd.  Party, but not mentioned.
  337.    Overscan is used for all modes, adjust your Overscan-size with the ScreenMode Preference Tool.
  338.    This list will only be avaible if the icon called "Mode_Names" supplied with Workbench 2.0 is in the WBStartup directory of your boot drive.
  339.    This  Mode_Names may also be obsolete in new versions of the workbench.
  340.    NOTE:
  341.       @{b}DON'T@{ub} use VGA-Modes on a NON-Multisync or NON-VGA-Monitor @{b}DON'T@{ub} even test Modes if you aren't sure about your Monitor-capacibilities.
  342.    NOTE:
  343.       Again, be careful please.
  344.    NOTE:
  345.       The above list will be COMPLETLY different if you use WB 3.0 on one of the new AGA Amigas (A1200/A4000).
  346. @EndNode
  347. @Node PROBLEMS "BTD/Known Problems"
  348. @{b}Known Problems@{ub}
  349. We do kwow about some problems and magic matters, some of them are explainable even.
  350. -  Most of them are covered by the new and all over complicated MUI and the preference program. Sometimes it is usefull to delete the MUI-preferences: ENV(ARC):MUI/BTD.#?
  351. -  You have choosen 4 modules, but not even one be will used! This is not a bug, this is a configuration problem. Normally this is a color problem, as the in total usage of colors of all the modules does not have to exceed the number of colors a screen mode is offering you. Solution: configure each module to use less colors and that the total use is feaseble. Or use less modules.
  352. -  You are running a C-Compiler or a raytracer.  BTD goes blank, but doesn't show any swarm, and during disk-access BTD comes up for a while.
  353.    This is not a Bug, this is the @{b}FEATURE@{ub} of BTD !!  This is the way BTD blanks when high Cpu-use happens on the startup.  And during disk-access the Cpu-time is usually less, so BTD may find time to draw something.
  354. -  Collision with other Blankers.  Well, in fact you can run as many Blankers as you want.  Such as DMouse, Spliner, FracBlanc.  BTD does always try to move it's screen to front, when it detects to be behind some other screens.
  355. -  When a disk is inserted, BTD closes the screen (dis-blanks). This is normal.  Disk-replacement is detected as an input Event.  As all input events shall disable the Blanker this one should, too.  And this event is obvious, the user is alive :-)
  356. -  The window doesn't open if the hotkey is pressed.  Perhaps you have supplied a wrong hotkey description.  Use the Commodities Exchange Tool to open the @{"Edit Window" Link EDIT}.  The Hot Key will appear in the Gadget 'Pop Key'.  You can test the hotkey there.  If an incorrect hotkey was submitted, the old hotkey will reappear.
  357. -  BTD shows up the window though the Tool Type CX_POPUP is set to 'NO'.  This happens when BTD is started twice.  (Double-click (or call from CLI) = start, another double-click (or call from CLI) opens the window).  Please do also check the entries in the MUI Preferences.
  358. -  BTD makes noice when it blanks the screen.  This may happen when a Display Mode is choosen, which is not of the size of the since then activ screen.  Nothing dangerous.  Hardware.
  359. -  BTD makes flickers on the Monitor when it blanks the Screen. This happen when BTD blanks on a PAL-Screen, but the since then or then active Screen is or was NTSC.  (Or vice versa) The Monitor needs a bit time to synchronize again.  Nothing dangerous.
  360. -  The Edit Window does not open when the Pop Key is pressed.  Maybe you have used the wrong Hot Key.  Use the Commodities Exchange Tool to open the window.  In the gadget 'Pop Key' you can enter a Hot Key.  If the Key description is wrong, the old (may be default) Hot Key is displayed and used.  Please do also check the MUI Preferences.
  361. -  Some of those Power- Pro- and whatever-Tracker have serious problems, when BTD blanks.  In fact they do have problems with all blankers.  As for PowerTracker i know for sure, it's it's own fault, because this programm does NOT open an Intuition-Screen, but a CopperList.  And then it believes it does own the whole system.. *sigh*
  362. @EndNode
  363. @Node MUI "BTD/MUI"
  364. @{b}MUI@{ub}
  365. For BTD  V1.0 the Magic User Interface (MUI) system from  Stefan  Stuntz  was  used,  which helps the programmer saving a lot of time developing the GUI.  Also, the user has a wide range of influence to the GUI now.
  366. MUI is a shareware product worth using. It can be found on the AmiNet or other PD- and Shareware series. 
  367. Without registering MUI the only feature which is not available is that you can't save but change the preferences.  Thus MUI is usable even without registration.
  368. Please do read the file @{"'ReadMe.MUI'" Link "ReadMe.MUI"}, which should be in the Archive.
  369. We have decided to release BTD  V1.0 as MUI application, because MUI involves a new and usable standard for graphical user interfaces which we never would have achieved without serious programming, which would have exeeded the surrounding of a simple commodity.
  370. Already the work needed to make that one window fontsenstive (we have a internal version working !) is not justified to continue with GadTools, at least not, when working non-professional.  BTD II 2.0 using GadTools with the features of MUI would have been 15 to 20kb larger (not to speak from the source code) as a version made with MUI. And we only make use of the MUI-library when we open the window, thus we don't need the library at start time.  And nowadays there are so many nice tools written for and with MUI, that the MUI library is not needed for BTD alone.
  371. @EndNode
  372. @Node BLANKERS "BTD/Blankers"
  373. @{b}Blankers@{ub}
  374. Currently the number of modules used at the same time on the same screen are defined by the server option Blankers X and Y.
  375. Using X and Y, the screen will be seperated into regular squares. Each module will be given his own square.
  376. Which modules are used is choosen in the listview 'blankers'.
  377. If there are then given 4 squares by choosing a 2 x 2 split, and in the listview 'blankers' 4 modules are choosen, then these 4 modules will be used.
  378. Are there 4 squares, but only 3 modules, one random module will be used.
  379. Are there 4 squares, but more than 4 modules, only 4 randomly chooses modules will be used. Only choosen upon start.
  380.  Colors.
  381. Some modules offer color options. As you can run several modules, the number of choosen colors and the choosen display mode will influence the really choosen modules.
  382. The module BTD or instance will only use 2 colors, this means many of these modules can be started. By using PAL:Lores a total amount of 12 (they all share the background color), but not 16, because that many modules would require 32 colors excluding background color.
  383. If you additionally choose Rotor or Rain, more colors will be required. As graphic boards are nor supported directly, and HAM6 and HAM8 cannot be choosed, the frontiers are given by ECS and AGA and offer up to 256 colors. By using CyberGraphics though, you can use up to 65000 colors on your graphic board!
  384. A basic rule is: The more colors a module is given, the less modules you can run at the same time.
  385. We currently do not have a concept to implement shared-pens, a rather complicated thing.
  386. @EndNode
  387. @Node REXX "BTD/Rexx"
  388. @{b}Rexx@{ub}
  389. The Rexx-Interface is straight forward and usfull is a program is started which does not like BTD as screen blanker.
  390. The commands do resemble the commodities exchange program.
  391. The ARexx-Port is called 'BTD' and does know about these commands:
  392.  DISABLE     - stops BTD temporarily
  393.                
  394.  ENABLE      - re-starts BTD immediately.
  395.  BLANK       - starts the blanking process immediately.
  396.  RELOAD      - Flushes all modules and reloads them.
  397.  QUIT        - Quits BTD.
  398.  SHOW        - Opens configuration window.
  399.  HIDE        - Closes or iconifies the configuration window.
  400. @EndNode
  401. @Node CREDITS "BTD/Credits"
  402. @{b}Credits@{ub}
  403. Mario Kemper, Ral Schmidt, Markus Stipp and Stefan Becker for first beta tests, ideas and supplement of the until now only non-BTD-Core-Team-Module 'Scooter'. A faszinating module.
  404. SAS/C group for the good work.  
  405.                       Markus Illenseer
  406.                       Matthias Scheler
  407.                         July 1995
  408. @EndNode
  409. @Node HISTORY "BTD/History"
  410.  BTD - Beyond the Dark - was developed for fun and love into details and has only been published by pressure of friends. We currently do not know who first had the idea for this project. We have been developed on it for more than one year without ever really intending to release it.
  411.  BTD is, what a surprise, a successor of the beloved and famous BTD. Like his predecessor, it has been designed to be stable and conform, not for speed. Hard but the truth is, that you need a faster machine. When dumb PC-games ask for at least an 486 DX/2 66Mhz, we ask for an MC68030.
  412. @EndNode
  413.